netease-ui-binder

Declare the control path in the UIPath class in Config.py, then write a method in the page's nested Bindable class decorated with @bindString, @bindFloat, @bindInt, or @bindBool passing that path. The decorator generates an #nkui_ hash binding name used in the JSON bindings array.

Use the composite decorators @toggle, @slider, or @editBox with the control path. Capture owner = self, define inner functions like onChange and value, and return them as a tuple; inner function names must stay fixed because they feed the binding hash.

Binding names are md5 hashes of the control path plus a type tag, so renaming a UIPath constant or a composite inner function changes the hash. Renaming classes, methods, or moving files does not. Run tools/gen_bindable_map.py to see added or changed bindings.

Bind a @bindFloat method returning 1.0 - progress, then on the image control add a binding with binding_name_override set to #clip_ratio and clip_direction set. clip_ratio 0 means full bar and 1 means empty.

Label text is parsed as an expression, so a single % breaks rendering. Escape it as %% in JSON and in Python binding return values, for example "{:.0f}%%".format(value), and use \\n for newlines.

Yes. Return a texture path from a @bindString method and add binding_name_override set to #texture on the image control itself, since bindings do not propagate from parent to child. Keep $default_texture as a fallback value.