class: SJUILabel
inherits: UILabel

• ✅ UIKit: Full support (All attributes available)
• ✅ SwiftUI: Full support (All attributes available through DynamicComponent)
• ✅ Jetpack Compose: Full support (Maps to Text composable)
• ✅ Android XML: Maps to com.kotlinjsonui.views.KjuiTextView (custom view with font support)

You can dynamically bind values to partialAttributes ranges using the @{} syntax:

{
  "type": "Label",
  "id": "price_label",
  "text": "Total: $99.99 (Save 20%)",
  "data": [
    {
      "name": "priceStart",
      "class": "Int",
      "defaultValue": 7
    },
    {
      "name": "priceEnd",
      "class": "Int",
      "defaultValue": 13
    }
  ],
  "partialAttributes": [
    {
      "fontColor": "#FF0000",
      "fontSize": 20,
      "font": "bold",
      "range": ["@{priceStart}", "@{priceEnd}"]
    },
    {
      "fontColor": "#00AA00",
      "fontSize": 14,
      "range": [15, 24]
    }
  ]
}

This generates binding code that updates the range dynamically:

priceLabel?.partialAttributesJSON?[0]["range"][0] = JSON(priceStart)
priceLabel?.partialAttributesJSON?[0]["range"][1] = JSON(priceEnd)

{
  "type": "Label",
  "id": "terms_label",
  "text": "By clicking agree, you accept our Terms of Service and Privacy Policy",
  "fontSize": 14,
  "fontColor": "#333333",
  "data": [
    {
      "name": "termsStart",
      "class": "Int",
      "defaultValue": 33
    },
    {
      "name": "termsEnd",
      "class": "Int",
      "defaultValue": 49
    },
    {
      "name": "privacyStart",
      "class": "Int",
      "defaultValue": 54
    },
    {
      "name": "privacyEnd",
      "class": "Int",
      "defaultValue": 68
    }
  ],
  "partialAttributes": [
    {
      "fontColor": "#0066CC",
      "underline": {
        "lineStyle": "Single",
        "color": "#0066CC"
      },
      "range": ["@{termsStart}", "@{termsEnd}"],
      "onclick": "openTerms"
    },
    {
      "fontColor": "#0066CC",
      "underline": {
        "lineStyle": "Single",
        "color": "#0066CC"
      },
      "range": ["@{privacyStart}", "@{privacyEnd}"],
      "onclick": "openPrivacy"
    }
  ]
}

{
  "type": "Label",
  "id": "search_result_label",
  "text": "Swift is a powerful and intuitive programming language",
  "binding_group": ["search"],
  "data": [
    {
      "name": "searchResultRanges",
      "class": "[Int]",
      "defaultValue": []
    }
  ],
  "partialAttributes": [
    {
      "fontColor": "#FF6600",
      "backgroundColor": "#FFFF00",
      "range": "@{searchResultRanges}"
    }
  ]
}

In your ViewController:

// Update search highlights
_binding.searchResultRanges = [0, 5, 35, 46]  // Highlights "Swift" and "programming"
_binding.invalidateSearch()

• The range array can contain either static numbers or dynamic bindings using @{}
• When using @{} in range, the variable should be of type Int or [Int]
• The binding updates the partialAttributesJSON property, which is then applied when the text is rendered
• You can mix static and dynamic values in the same partialAttributes array

open class var viewClass: SJUILabel.Type

This property will be used to decide which class to inflate with createFromJSON method. You should define the view's class on this property when you create classes inherite SJUILabel.

static var defaultLinkColor: UIColor

Default color for links (blue). Used when linkable is true and no color is specified.

static var verticalAdjustmentByFonts: [String:CGFloat]

Font-specific vertical adjustments dictionary for fine-tuning text positioning per font.

public var hint: String?

Placeholder text displayed when main text is empty. Explanation is in Attributes table.

public var selected: Bool

Selection state that determines which attributes to use (normal or highlighted).

public var attributes: [NSAttributedString.Key:NSObject]!

This property stores label's attributes for normal state. When you want to set attributedText, call applyAttributedText instead of setting attributedText directly.
This property will be used to create attributed text.

public var highlightAttributes: [NSAttributedString.Key:NSObject]!

Attributes used when applyAttributedText is called and the label is selected.

public var hintAttributes: [NSAttributedString.Key:NSObject]?

Text attributes for hint text when hint is displayed.

public var partialAttributesJSON: [JSON]?

JSON-based partial text styling configuration. Stores the partial attributes defined in JSON.

public var linkable: Bool

When this property is true, URLs in the text will be automatically detected and made clickable.

public var touchedURL: URL?

The URL that was touched in linkable text. Available after a link is tapped.

public var linkedRanges: [[String:Any]]

Array of linked text ranges with their associated actions and properties.

public weak var touchDelegate: UIViewTapDelegate?

Delegate for handling touch events on the label.

public weak var linkHandleDelegate: NSObject?

Object to handle link click events when linkable is enabled.

public var padding: UIEdgeInsets

Internal padding for text rendering. Spaces between text and its frame.

override var intrinsicContentSize: CGSize { get }

Content size calculation including padding adjustments.

override var alignmentRectInsets: UIEdgeInsets { get }

Alignment rectangle insets for proper layout alignment.

public class func createFromJSON(attr: JSON, target: Any, views: inout [String: UIView]) -> SJUILabel

Factory method called when the label is created from JSON file.
Override this method when you create classes inheriting from SJUILabel class.

open func applyAttributedText(_ text: String!)

Call this method to set attributedText with proper attribute handling.

• Uses attributes for normal state
• Uses highlightAttributes when selected is true
• Uses hintAttributes when text is empty and hint is provided
• Handles partial attributes from partialAttributesJSON

open func applyLinkableAttributedText(_ text: String!, withColor color: UIColor = defaultLinkColor)

Call this method to set attributedText with automatic link detection and styling.
URLs in the text will be made clickable with the specified color.

func characterIndexAtPoint(_ touchPoint: CGPoint) -> Int?

Returns the character index at the specified touch point. Used for handling touches on specific text ranges.

override func drawText(in rect: CGRect)

Custom text drawing implementation that applies padding and handles special rendering.

override func sizeThatFits(_ size: CGSize) -> CGSize

Size calculation that includes padding in the final size.

override func touchesBegan(_ touches: Set<UITouch>, with event: UIEvent?)
override func touchesCancelled(_ touches: Set<UITouch>, with event: UIEvent?)
override func touchesMoved(_ touches: Set<UITouch>, with event: UIEvent?)
override func touchesEnded(_ touches: Set<UITouch>, with event: UIEvent?)

Touch handling methods for link detection and tap events.

override func onBeginTap()
override func onEndTap()

Custom touch begin and end handling inherited from SJUIView.

@objc func onLinkTap(_ sender: UITapGestureRecognizer)

Handles tap events on clickable links when linkable is enabled.