Class: AlSelector

Inherits:
AlWidget show all
Defined in:
lib/al_form.rb

Overview

セレクタウィジェット スーパークラス

(チェックボックス、プルダウンメニュー、ラジオボタン)

Direct Known Subclasses

AlCheckboxes, AlOptions, AlRadios

Instance Attribute Summary (collapse)

Attributes inherited from AlWidget

#filter, #foreign, #hidden, #label, #message, #name, #required, #tag_attr, #value

Instance Method Summary (collapse)

Methods inherited from AlWidget

#set_attr

Constructor Details

- (AlSelector) initialize(name, arg = {})

(AlSelector) constractor

AlWidget#initialize argは親クラスも参照

Parameters:

  • name (String)

    ウィジェット識別名 英文字を推奨

  • arg (Hash) (defaults to: {})

    引数ハッシュ

Options Hash (arg):

  • :options (Hash)

    選択オプションのハッシュ

  • :separator (String)

    HTMLタグを生成する場合のタグ間セパレータ

See Also:



893
894
895
896
897
898
# File 'lib/al_form.rb', line 893

def initialize( name, arg = {} )
  super( name, arg )
  @options = arg[:options]
  @separator = arg[:separator]
  raise "Need ':options' parameter when make widget."  if ! @options
end

Instance Attribute Details

- (Object) options (readonly)

Hash

選択項目のハッシュ



878
879
880
# File 'lib/al_form.rb', line 878

def options
  @options
end

- (Object) separator (readonly)

String

HTMLタグを生成する場合のタグ間セパレータ



881
882
883
# File 'lib/al_form.rb', line 881

def separator
  @separator
end

Instance Method Details

- (String) make_tag(arg = {})

Note:

フラグ @hidden の時のみ対応。その他はサブクラスへ委譲。

(AlSelector) HTMLタグの生成

Parameters:

  • arg (Hash) (defaults to: {})

    htmlタグへ追加するアトリビュートを指定

Returns:

  • (String)

    htmlタグ



945
946
947
948
949
950
951
952
953
# File 'lib/al_form.rb', line 945

def make_tag( arg = {} )
  @options.each do |k,v|
    if @value && @value.to_s == k.to_s
      return %Q(<input type="hidden" name="#{@name}" id="#{@name}" value="#{Alone::escape_html(k)}" #{AL_FORM_EMPTYTAG_CLOSE}\n)
    end
  end

  return ""
end

- (String) make_value(*arg)

(AlSelector) HTML値の生成

Parameters:

  • arg (String)

    表示値。指定なければ内部値を使う。

Returns:

  • (String)

    html文字列



962
963
964
965
966
967
968
# File 'lib/al_form.rb', line 962

def make_value( *arg )
  v = arg.empty? ? @value: arg[0]
  if v == "" || v == nil
    return ""
  end
  return Alone::escape_html( @options[v] || @options[v.to_sym] || @options[v.to_s] || @options[v.to_i] )
end

- (Object) set_value(v) Also known as: value=

(AlSelector) 値のセット

Parameters:

  • v (String, NilClass)

    セットする値



906
907
908
909
# File 'lib/al_form.rb', line 906

def set_value( v )
  # 選択されない場合をnilで統一するため、ヌルストリングはnilへ変換する。
  @value = (v == "") ? nil : v
end

- (Boolean) validate

(AlSelector) バリデート

Returns:

  • (Boolean)

    成否



918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
# File 'lib/al_form.rb', line 918

def validate()
  @message = ""

  if @value == "" || @value == nil
    if @required
      @message = "#{@label}を選んでください。";
      return false
    end
    return true
  end

  if ! @options[@value.to_sym] && ! @options[@value.to_s] && ! @options[@value.to_i]
    @message = "#{@label}の入力が、規定値以外です。";
    return false
  end

  return true
end