Hacktoberfest 2026:メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

Add hints / guards against silent or unclear failures

オープン
#218 コメント 5 件 リアクション 0 件 担当者 0 名 GitHub で見る

まだ誰も着手していません。

評価

難易度
5/5
見積もり時間
1週間以上
初心者へのやさしさ
25/100
issue の種類
機能追加
明瞭さ
説明が足りない
活発さ
停滞
技術スタック
javascript

調査の方向性

まず、列挙されている Workbench のケースを再現します。サポートされていない子要素、複数の子要素、Gtk.Adjustment のプロパティ順序、グループ化された ToggleButtons、アイコンの欠落です。次に、Workbench がこれらの例を現在どのように報告または処理しているかを確認し、それぞれのケースに対する明確な動作を定義します。完了とは、ユーザーに明確なフィードバックが提供されるか、問題のある描画がフリーズなしで防止されることを意味します。

索引モデルが issue の本文から書いたものです。

説明

Some things fail (or crash even) silently—we should add measures to inform users and possibly prevent the rendering.

https://floss.social/@sonny/109975391706946091

I discussed with James if this belongs in Blueprint or Workbench, no clear winner. Let's start/iterate in Workbench and possibly transfer to Blueprint later.

No child allowed

crash: no
priority: high

Passing children to objects that don't accept any such as Label will not provide any feedback. It is confusing to beginners as the children don't get rendered but no explanation is given.

We should emit an error.

Label {
  label: "Hello";
  Button {
    label: "World";
  }
}

Single child allowed

crash: no
priority: high

Some widgets like AdwStatusPage, Adw.Clamp, ScrolledWindow, ... allow only one child. It doesn't error but only the last child will be rendered. It's confusing and makes the user think they did something wrong.

OK

Adw.StatusPage {
  Button {
    label: "a";
  }
}

KO

Adw.StatusPage {
  Button {
    label: "a";
  }
  
  Button {
    label: "b";
  }
}

Order of properties on Gtk.Adjustment

crash: no
priority: medium

OK:

      Scale one {
        width-request: 130;
        adjustment: Gtk.Adjustment {
          lower: 0;
          upper: 100;
          value: 50;
        };
      }

KO:

      Scale one {
        width-request: 130;
        adjustment: Gtk.Adjustment {
          lower: 0;
          value: 50;
          upper: 100;
        };
      }

https://matrix.to/#/!aUhETchlgthwWVQzhi:matrix.org/$16780187509362SfqjZ:gnome.org?via=gnome.org&via=matrix.org&via=libera.chat

ToggleButton grouped to each others

Grouping ToggleButtons to each others will render fine but will cause Workbench to freeze when clicking on one of them.

crash: yes
priority: low

KO

using Gtk 4.0;
using Adw 1;

Box {
  halign: center;
  valign: center;
  orientation: horizontal;
  
  ToggleButton button_first {
    label: "Toggle On";
    group: button_second;
  }

  ToggleButton button_second {
    label: "Toggle Off";
    group: button_first;
  }
}

OK:

using Gtk 4.0;
using Adw 1;

Box {
  halign: center;
  valign: center;
  orientation: horizontal;
  
  ToggleButton button_first {
    label: "Toggle On";
  }

  ToggleButton button_second {
    label: "Toggle Off";
    group: button_first;
  }
}

icon not found

crash: no
priority: low

https://matrix.to/#/!kDBZrVKCdhrVuWxbGe:matrix.org/$GI0tPROepvgJBYCqjapML5GqxIXxS6bHukuFrj9RttQ?via=gnome.org&via=matrix.org&via=catgirl.cloud

some references does'nt show up and are replaced by a corrupted icon which looks odd

If we detect an icon as not fund - we could show a hint to lookup the icon library in the menu

主要言語
JavaScript
スター
846
フォーク
91
PR マージ指標
30日以内にマージされた PR はありません

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

workbenchdev/Workbench のほかの issue

workbenchdev/Workbench の issue をすべて見る

似ている issue

JavaScript の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。