• Resolved Widget Direction
  • Robust
  • My favorite, unless a better solution is found
• Keyboard-Layout Direction
  • Not available all the time
  • Currently is used in GTK+ to override the last item when available
  • Feels better if you are entering text in the other direction
  • Neutral paragraph will jump to the other side when you leave the field...
    • ...unless you put markup to remember the direction...
      • ...which makes it quite complicated
      • and hard to predict
• GNOME Bugs #116626 and #136529

Right direction (RTL)

نمی‌دانم. ولی به نظر تنها کاری می‌رسید که در هفته‌ی اولِ ژانویه‌ی ۱۹۶۴ می‌شد انجام داد، و دو نفر را هم پیدا کردم که همراهی‌ام کنند. یکی از آن‌ها خواسته که نامش فاش نشود، که عیبی ندارد...		نمی‌دانم. ولی به نظر تنها کاری می‌رسید که در هفته‌ی اولِ ژانویه‌ی ۱۹۶۴ می‌شد انجام داد، و دو نفر را هم پیدا کردم که همراهی‌ام کنند. یکی از آن‌ها خواسته که نامش فاش نشود، که عیبی ندارد...		نمی‌دانم. ولی به نظر تنها کاری می‌رسید که در هفته‌ی اولِ ژانویه‌ی ۱۹۶۴ می‌شد انجام داد، و دو نفر را هم پیدا کردم که همراهی‌ام کنند. یکی از آن‌ها خواسته که نامش فاش نشود، که عیبی ندارد...
نمی‌دانم. ولی به نظر تنها کاری می‌رسید که در هفته‌ی اولِ ژانویه‌ی ۱۹۶۴ می‌شد انجام داد، و دو نفر را هم پیدا کردم که همراهی‌ام کنند. یکی از آن‌ها خواسته که نامش فاش نشود، که عیبی ندارد...		نمی‌دانم. ولی به نظر تنها کاری می‌رسید که در هفته‌ی اولِ ژانویه‌ی ۱۹۶۴ می‌شد انجام داد، و دو نفر را هم پیدا کردم که همراهی‌ام کنند. یکی از آن‌ها خواسته که نامش فاش نشود، که عیبی ندارد...		نمی‌دانم. ولی به نظر تنها کاری می‌رسید که در هفته‌ی اولِ ژانویه‌ی ۱۹۶۴ می‌شد انجام داد، و دو نفر را هم پیدا کردم که همراهی‌ام کنند. یکی از آن‌ها خواسته که نامش فاش نشود، که عیبی ندارد...

Wrong direction (LTR)

Classic from Pango Gallery

• Translator decides that a locale is Right-to-Left
  ...good way, but eventually the Glibc locale should provide this information
• All in a sudden, Left and Right are swapped!
• Did you have this in mind?
• Widget directions default to Right-to-Left
• Horizontal packing is done from Right to Left
• X Align is done from Right to Left

gedit under en_US (English) locale:

gedit under fa_IR (Persian) locale:

AbiWord under en_US (English) locale:

AbiWord under fa_IR (Persian) locale:

/* justification for label and maybe other widgets (text?) */
typedef enum
{
  GTK_JUSTIFY_LEFT,
  GTK_JUSTIFY_RIGHT,
  GTK_JUSTIFY_CENTER,
  GTK_JUSTIFY_FILL
} GtkJustification;

void             gtk_label_set_justify (GtkLabel         *label,
                                        GtkJustification jtype);
GtkJustification gtk_label_get_justify (GtkLabel         *label);

(GTK_JUSTIFY_FILL is just a place-holder right now)

LEFT

RIGHT

CENTER

FILL

Wrong!

• Should change direction under Right-to-Left locale? (widget direction)
• Should change direction under Right-to-Left paragraph? (paragraph direction)
• Do you mean the other side?

2³=8 different alignment functions

User:
Password:
Language:	English

         

کاربر:
گذرواژه:
زبان:	فارسی

• Sounds good, we have two of these, add the other six: New values, backward compatible!

But Wait!

• Add up to 10 counting for Center and Fill too, can you name them?
• Current GTK_JUSTIFY_LEFT and GTK_JUSTIFY_RIGHT are wrong
  • Fix the code?
  • Then applications break :-(
  • What a Western developer means by LEFT, most probably is: LEFT for Latin and RIGHT for Arabic, which is the current behavior

• Define bit masks for new alignments in GtkJustification, deprecate old values and keep for compatibility

/* Reading directions for text */
typedef enum
{
  GTK_TEXT_DIR_NONE,
  GTK_TEXT_DIR_LTR,
  GTK_TEXT_DIR_RTL
} GtkTextDirection;

/* Functions for setting directionality for widgets*/
void             gtk_widget_set_direction         (GtkWidget        *widget,
                                                   GtkTextDirection  dir);
GtkTextDirection gtk_widget_get_direction         (GtkWidget        *widget);
void             gtk_widget_set_default_direction (GtkTextDirection  dir);
GtkTextDirection gtk_widget_get_default_direction (void);

• Unlike what comment and names suggest, this is used for all packing and other widget directions too (comments in source explain that)
• The default direction is initialized by the locale direction
• Since our paragraph direction propagation algorithm hardly relies on the widget direction, user should not need too much control over this! Good
• GTK_TEXT_DIR_NONE means default direction, what about reverse of the default direction? Add value to enum for completeness?

• HTML/CSS model does this
• Allows RTL and LTR layouts simultaneously

• Current locale model in Glibc does not allow two locales simultaneously anyway
• Current model in GTK+ does not allow that
• Childs are binded to parents after initialization
• Is complicated and hard to predict

• It's just the beginning
• All those LEFTs and RIGHTs in gtkenums.h are scary
• A framework for icon translation? Sure? What about themes then?
• Lots of work needs to be done in individual applications...
• ...not a big problem, those who care about Bidirectional layouts go and fix them
• Didn't covered in this talk: Cursor movement and mouse selection

• Start a working group on freedesktop.org and document these all
• Write HOWTOs for different toolboxes on how to design bidi-friendly layouts
• Work with GNOME Usability people to update the HIG if necessary, and add needed checks to their checklists

~FIN~